home *** CD-ROM | disk | FTP | other *** search
/ MacHome 2001 January / MacHome Magazine Demo Disc January 2001.iso / mac / Software / Utilities / Black & Bleu™.sea / Black & Bleu™ / Printable instructions / 05. Database Organization / 05. Database Organization
Encoding:
Text File  |  2000-05-20  |  2.5 KB  |  53 lines  |  [TEXT/ttxt]
  1. Database Organization
  2. When an error is reported to you it is either described as a phrase such as “The Disk is full” or the less friendly “error -34” form. Rarely do you see the name of the error “dskFullErr”. But Apple uses the error name as the basis for identifying and organizing the error lists.
  3.  
  4. Black & Bleu’s error database is organized around the assumption that each error has a unique name. That way, errors that use the same number as other errors can be distinguished from each other. There are hundreds of cases where an error number is used over again by the Mac OS to mean different things.
  5.  
  6. Each error name is a string of letters (and possibly numbers and/or symbols) that is different from every other name. That is, no two error names are identical. Mostly, Apple has followed this naming convention.
  7.  
  8. There are some exceptions to the naming convention that we have encountered. They are described in the next paragraphs of this chapter.
  9.  
  10. Duplicate Error Names
  11. There are a few names that have been used twice and assigned different error numbers. These are:
  12.     – badComponentInstance
  13.     – badComponentSelector
  14.     – fidExists
  15.     – kOutOfMemoryErr
  16.     – telNoTools
  17.  
  18. In order for Black & Bleu™ to distinguish between these names, we have altered the second occurrence of the name slightly by adding the number “1” on the end. Thus, you will find the following in the database:
  19.  
  20. badComponentInstance    (-32767)              and
  21. badComponentInstance1  (-2147450879)
  22. These refer to the same error condition.
  23.  
  24. badComponentSelector   (-32766)              and
  25. badComponentSelector1 (-2147450878)
  26. These refer to the same error condition.
  27.  
  28. fidExists     (-1301)     and
  29. fidExists1   (-132)
  30. These refer to the same error condition.
  31.  
  32. kOutOfMemoryErr   (3001)  and
  33. kOutOfMemoryErr1 (2001)
  34. These refer to the same error condition.
  35.  
  36. telNoTools   (-10101)  and
  37. telNoTools1 (8)
  38. These refer to the same error condition.
  39.  
  40. Errors with no Name
  41. There are a total of 59 errors in the database that were assigned an error number but never given a name. It is unclear why no names were given to these errors. However, we have assigned our own names to them.
  42.  
  43. We selected the names:
  44.     – none001   through
  45.     – none059
  46. to represent these errors.
  47.  
  48. Errors with a Proprietary Name
  49. There are 2 errors in the database that have been declared “proprietary” by Apple. These errors have been assigned names but due to the terms of a non-disclosure agreement we signed with Apple, we cannot reveal them. 
  50.  
  51. Instead, we have given them the names:
  52. ApplePrivate1 (-8161)   and
  53. ApplePrivate2 (-8162)